home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 033a / today305.zip / TO-DAY.DOC < prev    next >
Text File  |  1992-02-03  |  5KB  |  120 lines
  1.                              TO-DAY
  2.                          by Roland Haley  
  3.  
  4.                       Release 3.05 02/03/92
  5.  
  6.  
  7. This  program determines the current date, then reads data  files 
  8. containing  historical facts and produces a file  of  interesting 
  9. information about the current date.  It is intended for use  with  
  10. PCBoard 14.5 systems. The files are created using the HEXADECIMAL
  11. codes so there is only one file to worry about.  This can be your 
  12. NEWS  file,  or any other that you choose.  If you prefer to have
  13. the file written with ANSII codes, then just change the colors in
  14. the TODAY.CFG file to suit.
  15.  
  16. TO-DAY.EXE  will read a file created just for your system, called
  17. "TODAY.LCL"  which should be placed in the same path as the other
  18. TODAY.xxx  files.  In  this file you enter the birthdates of your
  19. members and any other item for the entire year.   Just follow the
  20. format of the sample file.  In this way, you may "customize" your
  21. display  with special  events or reminders  you  desire,  without
  22. having  to edit the monthly files.
  23.  
  24. Also,  you can have a  NEWS  file that you create using ANY ascii
  25. text editor appended to the historical and  birthday trivia.  You
  26. must follow the format in the sample  file  in  order to  get the
  27. proper colorization of the news file.
  28.  
  29. You  can  also  limit  the number of lines this file will produce
  30. by entering the maximum number of lines allowed, in the .CFG file.
  31.  
  32. Plus, it also creates a  LOGOFF  file which is a one or two liner 
  33. when the user logs off your system. Each day is different.
  34.  
  35.  
  36. SETTING UP:
  37.  
  38. The only elements that need to be set up to operate this  program 
  39. are the TODAY.LCL file and the TODAY.CFG  file.  These files MUST 
  40. be located in the current logged directory whenever TO-DAY.EXE is
  41. executed.   
  42.  
  43. The TODAY.CFG only requires three lines.The first line containing
  44. the name of your BBS, and the second line containing the path and
  45. name of the file you want to write to,  and the third,  your path
  46. to the SCRIPT0 file. eg.
  47.  
  48. Haley's Comment BBS     <= (Line 1) Name of YOUR BBS
  49. D:\NEWS\0NEWS           <= (Line 2) Drive\Path\Name of file to write to
  50. D:\SCRIPT\SCRIPT0       <= (Line 3) Drive\Path\Name of your SCRIPT file
  51.  
  52. The following lines are a MUST if you are changing the colors.
  53. You  can  either  enter the file name or leave the line blank.
  54. If you do not wish to append a news text file  then leave  two
  55. blank lines instead of the following example.
  56.  
  57. D:\NEWS\0NEWS.TXT       <= (Line 4) Name of the news text file
  58. 300                     <= (Line 5) Maximum number of lines to copy
  59.  
  60. The following four lines should be added  ( using  your  own
  61. colors)  if you want to change the color of the printed file.
  62.  
  63. @X0F                    <= (Line 6) Color of main title
  64. @X0E                    <= (Line 7) Color of sub title
  65. @X0B                    <= (Line 8) Color of messages
  66. @X0D                    <= (Line 9) Color of line
  67. 0                       <= (Line 10) Indicates the log-off file is to be
  68.                                      written to PCBoard's SCRIPT0 file.
  69.                                      Place a 1 in this position to remove
  70.                                      the (;) from the leading edge.
  71.  
  72. **NOTE** ANSII codes can be placed in lines 6 through 9 if you so desire.
  73.  
  74.  
  75.  
  76. TESTING:
  77.  
  78. To test the program, simply type TO-DAY  <enter> and the output
  79. file  you  have  named  in  the  TODAY.CFG file will be created
  80. (or overwritten if it already exists), and so  will the SCRIPT0
  81. file.
  82.  
  83. OPERATION:
  84.  
  85. The recomended operation of  TO-DAY.EXE  is have it called from
  86. the  EVENT.SYS  file  during  your  automatic daily maintenance
  87. shortly after midnight.  Add these two lines to your  EVENT.SYS
  88.  
  89.  
  90. CD \NEWEVENT <--- You should change this to the directory where 
  91.                   TODAY.CFG will be located.
  92. TO-DAY.EXE   <--- Next, execute the program, which will get the
  93.                   date  from  the  system clock and produce the 
  94.                   output file(s) as specified in TODAY.CFG.
  95.  
  96. SPECIAL NOTE:
  97.  
  98. This program uses data files which are based on a data format and 
  99. content used by a number of similar programs. Consequently, other
  100. sources  produce  data  files  compatible  with  this format, and
  101. you may wish to merge them into these files.  Avoid  duplication,
  102. or  both  entries  will be displayed in your output file.   Also,
  103. be cautious about SORTING the new entries,  as the  SORT  routine
  104. may  be  confused  by  the  sequence of some of the multiple line 
  105. entries in these or other data files.
  106.  
  107. This program is free for you to use as you wish.  But please call
  108. Haley's  Comment  BBS  at  any of the numbers listed  below,  and
  109. register as a visiting SysOp.  This is done by filling out script
  110. questionnaire number 1 at the main command.   After approximately
  111. 24 hrs  you  will be given Visiting SysOp status and will be able
  112. to download the latest files,  also the latest  programs.
  113.  
  114. Roland Haley
  115.  
  116. Haley's Comment BBS
  117. (519) 469-3028 HST
  118. (519) 469-3173 HST
  119. (519) 539-6851 HST
  120.